home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Sound / delfinampeg / dmdev.readme < prev    next >
Text File  |  2001-06-19  |  5KB  |  126 lines
  1. Short:  Mpeg.device for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/play
  4.  
  5. $VER: delfinampeg.device 1.3 (Thu 14-Jun-2001)
  6.  
  7.  
  8.  #features
  9.    -plays MPEG audio files with almost no CPU load
  10.     (Delfina's DSP56002 does all the decoding and playback)
  11.  
  12.    -standard "mpeg.device" API
  13.     (code based on melodympeg.device by Thorsten Hansen)
  14.  
  15.    -free software
  16.     (full source code included, of course)
  17.  
  18.  
  19.  
  20.  #requirements
  21.    -CPU 68020+
  22.    -Delfina DSP board
  23.  
  24.  
  25.  
  26.  #changes since previous release
  27.    -new email address
  28.    -little code optimizing
  29.    -fixed a quite unobvious bug in the cleanupDelfina() routine
  30.     this avoids the "noisy deadlock" when seeking inside a file in AMPlifier
  31.     using delfina.library 4.14 (personally, I can tolerate the "fake crash"
  32.     bug of 4.14 but I *hate* the "sudden freeze" problem of the 4.16ß libs)
  33.  
  34.  
  35.  
  36.  #how to use it
  37.    Copy delfinampeg.device to your "devs:" drawer and configure an application
  38.    program to make use of it, for instance:
  39.  
  40.    AMPlifier    http://www.katodev.de
  41.        Configuration -> Audio I/O -> MPEG audio player -> Decoder
  42.        MPEG device:    delfinampeg.device
  43.        Unit:           0
  44.        Buffersize:     128 (recommended, use any value you want)
  45.        Blocksize:      16  (recommended, use any value you want)
  46.        set Layer I/II and Layer III to "Hardware" decoding
  47.  
  48.    Frogger      http://frogger.rules.pl
  49.        use the option ADECODER with mode DELFINA
  50.  
  51.    AmigaAMP     http://www.amigaamp.de
  52.        get the "MHI driver for mpeg.device" from Aminet: mus/play/mhimdev.lha
  53.        follow the installation instructions in the README file
  54.  
  55.    Especially owners of the slower Delfinas (i.e. Lite) might be interested
  56.    in the configuration options of delfinampeg.device, which can be used to
  57.    sacrifice some playback quality in order to reduce DSP load. The device
  58.    reads them from the environment variable DELFINAMPEG during OpenDevice().
  59.    The options are:
  60.  
  61.    L2MONO...........mp2 files: decode left channel only
  62.    L2RATE <number>..mp2 files: play at specified rate (given in kHz)
  63.    L3MONO...........mp3 files: decode left channel only
  64.    L3RATE <number>..mp3 files: play at specified rate (given in kHz)
  65.  
  66.    The given playback rate is automatically rounded to the nearest available
  67.    Delfina rate (16, 27, 32, 48 kHz; Delfina 1200/Plus: 12, 24, 36, 48 kHz).
  68.    example:
  69.    > setenv DELFINAMPEG l3rate 32 l2mono
  70.      (play mp3 files at 32 kHz, force mp2 decoding to mono)
  71.    > copy ENV:DELFINAMPEG ENVARC:
  72.      (save settings to disk)
  73.  
  74.  
  75.  
  76.  #known problems
  77.    -use the latest (beta?) delfina.library - the README of DelfMPEG contains
  78.     a list of known bugs in the library.
  79.  
  80.    -the MPEG decoding routines are taken from DelfMPEG, so the same
  81.     restrictions apply here:
  82.      -only MPEG-1 layer II and III audio files are supported.
  83.      -the decoding routines need a lot DSP processing power, especially
  84.       mp3 playback might overburden the slower Delfinas (i.e. Lite).
  85.       try the config options listed above if you get "stuttering" sound,
  86.       because that can be the result of the DSP decoding data too slowly.
  87.  
  88.    -equalizer and visual effect plugins of AMPlifier are currently not
  89.     supported. this is not a feature of the mpeg.device. AMPlifier needs to
  90.     copy the decoded audio data back from the sound board to main memory,
  91.     which it can only do with the Melody boards but not (yet) with Delfina.
  92.  
  93.  
  94.  
  95.  #acknowledgements
  96.    delfinampeg.device uses ideas/code from:
  97.    -MPEG Audio Layer II decoder by Fredrik Noring and Tomas Berndtsson
  98.     (an mp2 player for Atari Falcon, DSP56K code)
  99.    -amp11 by Niklas Beisert (clean and fast C++ code)
  100.    -FalcAMP by Denis "STGhost" Huguet and David "Splash" Carrere
  101.     (an mp3 player for Atari Falcon, DSP56K code)
  102.    -reference code by MPEG Software Simulation Group ("the original" C code)
  103.    -melodympeg.device by Thorsten Hansen
  104.  
  105.  
  106.  
  107.  #author
  108.    mailto: smack42@web.de
  109.  
  110.    delfinampeg.device - mpeg.device for Delfina DSP
  111.    Copyright (C) 2000, 2001  Michael Henke
  112.  
  113.    This program is free software; you can redistribute it and/or modify
  114.    it under the terms of the GNU General Public License as published by
  115.    the Free Software Foundation; either version 2 of the License, or
  116.    (at your option) any later version.
  117.  
  118.    This program is distributed in the hope that it will be useful,
  119.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  120.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  121.    GNU General Public License for more details.
  122.  
  123.    You should have received a copy of the GNU General Public License
  124.    along with this program; if not, write to the Free Software
  125.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  126.